Node / meshtastic / Meshtastic-Android / files / core / data / src / commonMain / kotlin / org / meshtastic / core / data / repository / FirmwareReleaseRepositoryImpl.kt

Displaying Raw • Download

T8b949e/*

* Copyright (c) 2026 Meshtastic LLC

*

* This program is free software: you can redistribute it and/or modify

* it under the terms of the GNU General Public License as published by

* the Free Software Foundation, either version 3 of the License, or

* (at your option) any later version.

*

* This program is distributed in the hope that it will be useful,

* but WITHOUT ANY WARRANTY; without even the implied warranty of

* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the

* GNU General Public License for more details.

*

* You should have received a copy of the GNU General Public License

* along with this program. If not, see <https://www.gnu.org/licenses/>.

*/

Tff7b72package T7ee787org.meshtastic.core.data.repository

Tff7b72import T7ee787co.touchlab.kermit.Logger

Tff7b72import T7ee787kotlinx.coroutines.flow.Flow

Tff7b72import T7ee787kotlinx.coroutines.sync.Mutex

Tff7b72import T7ee787kotlinx.coroutines.sync.withLock

Tff7b72import T7ee787kotlinx.serialization.json.Json

Tff7b72import T7ee787org.koin.core.annotation.Single

Tff7b72import T7ee787org.meshtastic.core.common.util.nowMillis

Tff7b72import T7ee787org.meshtastic.core.common.util.safeCatching

Tff7b72import T7ee787org.meshtastic.core.data.datasource.BundledAssetReader

Tff7b72import T7ee787org.meshtastic.core.data.datasource.FirmwareReleaseLocalDataSource

Tff7b72import T7ee787org.meshtastic.core.data.datasource.decode

Tff7b72import T7ee787org.meshtastic.core.data.util.staleWhileRevalidateFlow

Tff7b72import T7ee787org.meshtastic.core.database.entity.FirmwareRelease

Tff7b72import T7ee787org.meshtastic.core.database.entity.FirmwareReleaseEntity

Tff7b72import T7ee787org.meshtastic.core.database.entity.FirmwareReleaseType

Tff7b72import T7ee787org.meshtastic.core.database.entity.asDeviceVersion

Tff7b72import T7ee787org.meshtastic.core.database.entity.asEntity

Tff7b72import T7ee787org.meshtastic.core.database.entity.asExternalModel

Tff7b72import T7ee787org.meshtastic.core.di.CoroutineDispatchers

Tff7b72import T7ee787org.meshtastic.core.model.NetworkFirmwareRelease

Tff7b72import T7ee787org.meshtastic.core.model.NetworkFirmwareReleases

Tff7b72import T7ee787org.meshtastic.core.model.util.TimeConstants

Tff7b72import T7ee787org.meshtastic.core.network.FirmwareReleaseRemoteDataSource

Tff7b72import T7ee787org.meshtastic.core.repository.FirmwareReleaseRepository

Tff7b72import T7ee787kotlin.concurrent.Volatile

Tf0883e@Single

Tff7b72open Tff7b72class T56d364FirmwareReleaseRepositoryImplTb4b4b4(

Tff7b72private Tff7b72val Te6edf3remoteDataSourceTb4b4b4: Te6edf3FirmwareReleaseRemoteDataSourceTb4b4b4,

Tff7b72private Tff7b72val Te6edf3localDataSourceTb4b4b4: Te6edf3FirmwareReleaseLocalDataSourceTb4b4b4,

Tff7b72private Tff7b72val Te6edf3assetReaderTb4b4b4: Te6edf3BundledAssetReaderTb4b4b4,

Tff7b72private Tff7b72val Te6edf3jsonTb4b4b4: Te6edf3JsonTb4b4b4,

Tff7b72private Tff7b72val Te6edf3dispatchersTb4b4b4: Te6edf3CoroutineDispatchersTb4b4b4,

Tb4b4b4) Tb4b4b4: Te6edf3FirmwareReleaseRepository Tb4b4b4{

T8b949e/** Single-flight guard so concurrent collectors share one network refresh. */

Tff7b72private Tff7b72val Te6edf3refreshMutex Tff7b72= Te6edf3MutexTb4b4b4(Tb4b4b4)

T8b949e/** Guards [seedChecked] so concurrent collectors decode the bundled snapshot at most once per process. */

Tff7b72private Tff7b72val Te6edf3seedMutex Tff7b72= Te6edf3MutexTb4b4b4(Tb4b4b4)

Tf0883e@Volatile Tff7b72private Tff7b72var Te6edf3seedChecked Tff7b72= Tff7b72false

Tff7b72override Tff7b72val Te6edf3stableReleaseTb4b4b4: Te6edf3FlowTff7b72<Te6edf3FirmwareRelease?Tff7b72> Tff7b72= Te6edf3getLatestFirmwareTb4b4b4(Te6edf3FirmwareReleaseTypeTb4b4b4.Te6edf3STABLETb4b4b4)

Tff7b72override Tff7b72val Te6edf3alphaReleaseTb4b4b4: Te6edf3FlowTff7b72<Te6edf3FirmwareRelease?Tff7b72> Tff7b72= Te6edf3getLatestFirmwareTb4b4b4(Te6edf3FirmwareReleaseTypeTb4b4b4.Te6edf3ALPHATb4b4b4)

Tff7b72private Tff7b72fun Td2a8ffgetLatestFirmwareTb4b4b4(Te6edf3releaseTypeTb4b4b4: Te6edf3FirmwareReleaseTypeTb4b4b4)Tb4b4b4: Te6edf3FlowTff7b72<Te6edf3FirmwareRelease?Tff7b72> Tff7b72= Te6edf3staleWhileRevalidateFlowTb4b4b4(

Te6edf3loadFromCache Tff7b72= Tb4b4b4{

Te6edf3ensureSeededTb4b4b4(Tb4b4b4)

Te6edf3localDataSourceTb4b4b4.Te6edf3getLatestReleaseTb4b4b4(Te6edf3releaseTypeTb4b4b4)Tff7b72?.Te6edf3asExternalModelTb4b4b4(Tb4b4b4)

Tb4b4b4}Tb4b4b4,

Te6edf3shouldFetch Tff7b72= Tb4b4b4{ Te6edf3cached Tff7b72-Tff7b72>

Te6edf3cached Tff7b72=Tff7b72= Tff7b72null Tff7b72|Tff7b72| Te6edf3localDataSourceTb4b4b4.Te6edf3getLatestReleaseTb4b4b4(Te6edf3releaseTypeTb4b4b4)Tff7b72?.Te6edf3isStaleTb4b4b4(Tb4b4b4) Tff7b72!Tff7b72= Tff7b72false

Tb4b4b4}Tb4b4b4,

Te6edf3fetch Tff7b72= Tb4b4b4{ Te6edf3singleFlightRefreshTb4b4b4(Tb4b4b4) Tb4b4b4}Tb4b4b4,

Te6edf3context Tff7b72= Te6edf3dispatchersTb4b4b4.Te6edf3defaultTb4b4b4,

T8b949e// No collector blocks on the fetch (cache is emitted first), so let the HttpClient's own

T8b949e// timeout/retry policy bound it — api.meshtastic.org routinely takes 20-60s to serve this list,

T8b949e// and a short deadline here cancels every refresh, pinning users to the bundled seed data.

Te6edf3networkTimeoutMs Tff7b72= Tff7b72nullTb4b4b4,

Te6edf3tag Tff7b72= Ta5d6ff"Ta5d6ffFirmwareReleaseRepositoryTa5d6ff"Tb4b4b4,

Tb4b4b4)

Tff7b72override Tff7b72suspend Tff7b72fun Td2a8ffinvalidateCacheTb4b4b4(Tb4b4b4) Tb4b4b4{

Te6edf3localDataSourceTb4b4b4.Te6edf3deleteAllFirmwareReleasesTb4b4b4(Tb4b4b4)

Tb4b4b4}

T8b949e/**

* Applies the bundled snapshot per release type whenever it is newer than what is cached for that type — not just

* when the cache is empty. The bundle is refreshed weekly in CI, so an app update carries fresh data even for users

* whose network path to api.meshtastic.org chronically fails. Checked once per process; a cache that is already

* newer (from a successful network refresh) is never regressed, and a type the bundle doesn't ship is left

* untouched.

*/

Tff7b72private Tff7b72suspend Tff7b72fun Td2a8ffensureSeededTb4b4b4(Tb4b4b4) Tb4b4b4{

Tff7b72if Tb4b4b4(Te6edf3seedCheckedTb4b4b4) Tff7b72return

Te6edf3seedMutexTb4b4b4.Te6edf3withLock Tb4b4b4{

Tff7b72if Tb4b4b4(Te6edf3seedCheckedTb4b4b4) Tff7b72return

Te6edf3safeCatching Tb4b4b4{

Tff7b72val Te6edf3bundled Tff7b72= Te6edf3assetReaderTb4b4b4.Te6edf3decodeTff7b72<Te6edf3NetworkFirmwareReleasesTff7b72>Tb4b4b4(Ta5d6ff"Ta5d6fffirmware_releases.jsonTa5d6ff"Tb4b4b4, Te6edf3jsonTb4b4b4)Tff7b72?.Te6edf3releases

Tff7b72if Tb4b4b4(Te6edf3bundled Tff7b72=Tff7b72= Tff7b72nullTb4b4b4) Tb4b4b4{

Te6edf3LoggerTb4b4b4.Te6edf3w Tb4b4b4{ Ta5d6ff"Ta5d6ffFirmwareReleaseRepository: no bundled releases available to seed fromTa5d6ff" Tb4b4b4}

Tb4b4b4} Tff7b72else Tb4b4b4{

Tff7b72val Te6edf3toApply Tff7b72=

Te6edf3listOfTb4b4b4(

Te6edf3FirmwareReleaseTypeTb4b4b4.Te6edf3STABLE Te6edf3to Te6edf3bundledTb4b4b4.Te6edf3stableTb4b4b4,

Te6edf3FirmwareReleaseTypeTb4b4b4.Te6edf3ALPHA Te6edf3to Te6edf3bundledTb4b4b4.Te6edf3alphaTb4b4b4,

Tb4b4b4)

Tb4b4b4.Te6edf3filter Tb4b4b4{ Tb4b4b4(Te6edf3typeTb4b4b4, Te6edf3releasesTb4b4b4) Tff7b72-Tff7b72> Te6edf3isBundleNewerForTb4b4b4(Te6edf3typeTb4b4b4, Te6edf3releasesTb4b4b4) Tb4b4b4}

Tb4b4b4.Te6edf3toMapTb4b4b4(Tb4b4b4)

Tff7b72if Tb4b4b4(Te6edf3toApplyTb4b4b4.Te6edf3isNotEmptyTb4b4b4(Tb4b4b4)Tb4b4b4) Tb4b4b4{

Te6edf3LoggerTb4b4b4.Te6edf3i Tb4b4b4{ Ta5d6ff"Ta5d6ffFirmwareReleaseRepository: applying bundled snapshot for Tffd700${Te6edf3toApplyTb4b4b4.Te6edf3keysTffd700}Ta5d6ff" Tb4b4b4}

Te6edf3localDataSourceTb4b4b4.Te6edf3replaceFirmwareReleasesTb4b4b4(Te6edf3toApplyTb4b4b4)

Tb4b4b4}

Tb4b4b4}

Tb4b4b4}

Tb4b4b4.Te6edf3onFailure Tb4b4b4{ Te6edf3e Tff7b72-Tff7b72> Te6edf3LoggerTb4b4b4.Te6edf3wTb4b4b4(Te6edf3eTb4b4b4) Tb4b4b4{ Ta5d6ff"Ta5d6ffFirmwareReleaseRepository: failed to seed cache from bundled JSONTa5d6ff" Tb4b4b4} Tb4b4b4}

Te6edf3seedChecked Tff7b72= Tff7b72true

Tb4b4b4}

Tb4b4b4}

T8b949e/** True when [bundled] contains a release newer than anything cached for [type]. */

Tff7b72private Tff7b72suspend Tff7b72fun Td2a8ffisBundleNewerForTb4b4b4(Te6edf3typeTb4b4b4: Te6edf3FirmwareReleaseTypeTb4b4b4, Te6edf3bundledTb4b4b4: Te6edf3ListTff7b72<Te6edf3NetworkFirmwareReleaseTff7b72>Tb4b4b4)Tb4b4b4: Tffa657Boolean Tb4b4b4{

Tff7b72val Te6edf3bundledNewest Tff7b72= Te6edf3bundledTb4b4b4.Te6edf3maxOfOrNull Tb4b4b4{ Tffa657itTb4b4b4.Te6edf3asEntityTb4b4b4(Te6edf3typeTb4b4b4)Tb4b4b4.Te6edf3asDeviceVersionTb4b4b4(Tb4b4b4) Tb4b4b4} Tff7b72?: Tff7b72return Tff7b72false

Tff7b72val Te6edf3cachedNewest Tff7b72= Te6edf3localDataSourceTb4b4b4.Te6edf3getLatestReleaseTb4b4b4(Te6edf3typeTb4b4b4)Tff7b72?.Te6edf3asDeviceVersionTb4b4b4(Tb4b4b4)

Tff7b72return Te6edf3cachedNewest Tff7b72=Tff7b72= Tff7b72null Tff7b72|Tff7b72| Te6edf3bundledNewest Tff7b72> Te6edf3cachedNewest

Tb4b4b4}

Tff7b72private Tff7b72suspend Tff7b72fun Td2a8ffsingleFlightRefreshTb4b4b4(Tb4b4b4) Tb4b4b4{

Te6edf3refreshMutexTb4b4b4.Te6edf3withLock Tb4b4b4{

Te6edf3LoggerTb4b4b4.Te6edf3d Tb4b4b4{ Ta5d6ff"Ta5d6ffFirmwareReleaseRepository: fetching from remote APITa5d6ff" Tb4b4b4}

Tff7b72val Te6edf3releases Tff7b72= Te6edf3remoteDataSourceTb4b4b4.Te6edf3getFirmwareReleasesTb4b4b4(Tb4b4b4)Tb4b4b4.Te6edf3releases

Tff7b72if Tb4b4b4(Te6edf3releasesTb4b4b4.Te6edf3stableTb4b4b4.Te6edf3isEmptyTb4b4b4(Tb4b4b4) Tff7b72&Tff7b72& Te6edf3releasesTb4b4b4.Te6edf3alphaTb4b4b4.Te6edf3isEmptyTb4b4b4(Tb4b4b4)Tb4b4b4) Tb4b4b4{

Te6edf3LoggerTb4b4b4.Te6edf3w Tb4b4b4{ Ta5d6ff"Ta5d6ffFirmwareReleaseRepository: remote returned no releases; leaving cache untouchedTa5d6ff" Tb4b4b4}

Tb4b4b4} Tff7b72else Tb4b4b4{

T8b949e// Replace rather than upsert so releases pulled or reclassified upstream don't linger as "latest".

Te6edf3localDataSourceTb4b4b4.Te6edf3replaceFirmwareReleasesTb4b4b4(

Te6edf3mapOfTb4b4b4(Te6edf3FirmwareReleaseTypeTb4b4b4.Te6edf3STABLE Te6edf3to Te6edf3releasesTb4b4b4.Te6edf3stableTb4b4b4, Te6edf3FirmwareReleaseTypeTb4b4b4.Te6edf3ALPHA Te6edf3to Te6edf3releasesTb4b4b4.Te6edf3alphaTb4b4b4)Tb4b4b4,

Tb4b4b4)

Tb4b4b4}

Tb4b4b4}

Tb4b4b4}

Tff7b72private Tff7b72fun Te6edf3FirmwareReleaseEntityTb4b4b4.Td2a8ffisStaleTb4b4b4(Tb4b4b4)Tb4b4b4: Tffa657Boolean Tff7b72= Tb4b4b4(Te6edf3nowMillis Tff7b72- Tff7b72thisTb4b4b4.Te6edf3lastUpdatedTb4b4b4) Tff7b72> Te6edf3CACHE_EXPIRATION_TIME_MS

Tff7b72companion Tff7b72object Tb4b4b4{

Tff7b72private Tff7b72val Te6edf3CACHE_EXPIRATION_TIME_MS Tff7b72= Te6edf3TimeConstantsTb4b4b4.Te6edf3ONE_HOURTb4b4b4.Te6edf3inWholeMilliseconds

Tb4b4b4}

Tb4b4b4}